home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / vde131.arc / VDE131.DOC < prev    next >
Text File  |  1989-07-20  |  80KB  |  1,346 lines

  1.  
  2.  
  3.                                   VDE131.DOC
  4.                                   ----------
  5.                     Instructions for Video Display Editor:
  6.                                 MSDOS Version
  7.                                VDE 1.31 (03/89)
  8.  
  9.                               (c)1989, E. Meyer
  10.  
  11.  
  12. ==============================================================================
  13.  
  14.  
  15.     VDE is a small, fast, powerful text editor with many standard features:
  16.  
  17.   * multiple files, windows   * block operations     * subdirectory support
  18.   * wordwrap and reformat     * find and replace     * full DOS utilities
  19.   * margins, tabs, spacing    * undo deletions       * WordStar compatibility
  20.   * many print features       * keystroke macros     * configurable options
  21.  
  22. In addition, VDE has some unique features that you might not expect, including
  23.  
  24.       * automatic location of differences between versions of a file
  25.       * automatic sequential numbering         * word count
  26.       * full macro programming ability
  27.  
  28.      VDE is versatile: its small size and pure ASCII mode make it the ideal 
  29. programmer's editor, or companion to telecom, database, and other application 
  30. software; yet its full formatting and printing features also make it an 
  31. efficient word processor.
  32.      VDE is fast: it is written in 8086 assembler; on IBM PCs, it writes 
  33. directly to video RAM; it operates entirely in memory, with no disk access 
  34. during editing.  Speed is a factor that more cumbersome ("full-featured?") 
  35. programs overlook.  Example:  finding a string near the end of a 60K 
  36. nondocument file takes WordStar 4 about 20 seconds [8 MHz 8088]; VDE does it 
  37. in half a second.  This is like moving through air instead of molasses: you 
  38. will find that you can do more of your work on screen, and less on paper.
  39.      VDE is small: about 34k, with no overlays or additional files.  It can be 
  40. configured not to make backup files.  It can work with as little as 256K RAM.  
  41. This is ideal for portable computers with limited space.
  42.  
  43.      VDE requires MS/PCDOS version 2.x or higher, and a minimum of 256K RAM.  
  44. It can be installed either to optimize performance on IBM PC compatibles, or 
  45. to allow operation on any computer running MSDOS with an ANSI.SYS driver.  It 
  46. has many user configurable options.  [See VINSTALL.DOC for details.  Comments 
  47. below in brackets "[]" point out various uses of VINSTALL.]
  48.      Primary distribution points for VDE, as of October 1988, are:
  49.          (1) Glendale Littera QBBS - Glendale, CA  (818)956-6164.
  50.          (2) On CompuServe, in the download libraries of the IBMAPP forum.
  51. Users with access to a modem can always find the most recent release of VDE on 
  52. these systems.  In addition, VDE is available on a wide variety of other 
  53. remote systems, and also on disk through several software libraries, including:
  54.          The Public Software Library, P.O. Box 35705, Houston TX 77235.
  55.  
  56.  
  57.  
  58. ===============================  USAGE POLICY  ===============================
  59.  
  60.  
  61.       1.  VDE is FREE software: no fee is required for its use, 
  62.          copying, or NONprofit distribution.  (Voluntary contri- 
  63.          butions are welcome.)  For arrangements concerning sale 
  64.          for profit, contact the author.
  65.  
  66.       2.  Please do NOT write to request disks or manuals for VDE 
  67.          directly from the author.  VDExxx.ARC can be obtained from 
  68.          many sources including those mentioned above.
  69.  
  70.        ****************************************************************
  71.        *****      The VDE editor and its documentation are        *****
  72.        *****       (c)1989 E. Meyer, all rights reserved.         *****
  73.        *****   They may not be circulated in any incomplete or    *****
  74.        *****     modified form, nor sold for profit, without      *****
  75.        *****          written permission of the author.           *****
  76.        ****************************************************************
  77.  
  78.      DISCLAIMER: You undertake to use VDE at your own risk.  The author 
  79. accepts no liability for any damages resulting from its use or misuse.
  80.  
  81.                                   Eric Meyer
  82.                             401 12th Ave SE, #139
  83.                             Norman, OK  73071  USA
  84.  
  85.                            CompuServe [74415,1305]
  86.  
  87.  
  88.      Note:  "WordStar" is a trademark of MicroPro International, who have no 
  89. connection with the VDE editor or its author.
  90.  
  91.  
  92.  
  93. ================================  CONTENTS  ==================================
  94.  
  95.  
  96. 1. INTRODUCTION: Using this manual; Installation; Command line syntax, 
  97.                  examples; The VDE command set.
  98.  
  99. 2. COMMAND SUMMARY: a complete brief listing of all commands:
  100.                     Ctrl, ^K (Block), ^Q (Quick), ^O (Onscreen), Alt, Esc.
  101.  
  102. 3. EDITING COMMANDS, alphabetically by category:
  103.          Auto indent, Auto number, Block commands, Deleting, Disk operations, 
  104.     File commands, Find/replace, Graphics, Header, Hyphenation, Information, 
  105.     Insertion, Line spacing, Margins, Matching up files, Moving around, 
  106.     Multiple files, Pagination, Place markers, Printer codes, Printer drivers, 
  107.     Printing, Ruler line, Run command/shell, Screen controls, Splitting files, 
  108.     Tabs, Time/date, Undelete, Upper/lower case, Windows, Wordwrap & reformat.
  109.  
  110. 4. MACRO AND FUNCTION KEYS:  Explanation, with examples:
  111.          Function keys, Key definition files, Macros, Macro keys, 
  112.     Macro programming.
  113.  
  114. 5. GENERAL INFORMATION, alphabetically by category:
  115.          Directories, Disk space, Error messages, File modes, Memory, Prompts, 
  116.     Wordstar compatibility.
  117.  
  118. 6. TIPS ON USING VDE, alphabetically by topic:
  119.          Editing same file twice, Format conversion, Programming, Transposing 
  120.     text.
  121.  
  122. 7. VDE development history.
  123.  
  124.  
  125. =============================  1. INTRODUCTION  ==============================
  126.  
  127.  
  128.      If you want to get a quick start with VDE, and are already familiar with 
  129. the popular WordStar command set, you should be able to wade right in and edit 
  130. files.  But at some point you should read the whole manual through, to make 
  131. sure you're not missing anything -- especially the power of VDE's own extra 
  132. features.  (Read carefully; many things below are explained only once.)
  133.      Hint: If you need more on-line help than the menus (^J) provide while 
  134. learning to use VDE, it's an excellent idea to load VDE.DOC as a second file 
  135. while you work.  Then just switch to it and search (^QF) for the help you 
  136. need (for example, the word "margin").
  137.  
  138.      TO INSTALL VDE, use the VINSTALL configuration program; see the 
  139. accompanying file VINST.DOC.  Most of the installation consists of options; 
  140. you will discover how you want everything set in the course of using VDE, so 
  141. don't worry about all the details at first.  The one important thing is the 
  142. computer installation: you must specify whether you have a fully IBM 
  143. compatible PC.  In fact, an uninstalled copy of VDE will ask you this question 
  144. each time you run it -- reminding you to use VINSTALL.
  145.  
  146.      TO RUN VDE, you can just type "VDE"; or, you may specify a filename; or 
  147. up to six filenames, separated by commas.  Any filename may include a DOS 
  148. subdirectory, and/or be followed by a mode option.
  149.  
  150. SYNTAX:     note "{}" = optional
  151.  
  152.     C>vde {filename} {/m} {, filename2 {/m}} {,...} {;name.VDK} {;name.VDF}
  153.  
  154. EXAMPLES:   C>vde
  155.             C>vde sample.fil              C>vde myfile,myfile.bak
  156.             C>vde my.doc/w;ws4.vdf        C>vde prog.doc/a, prog.asm/n
  157.             C>vde a:work\letter /5        C>vde ch1,ch2,ch3,index/n
  158.  
  159.          "filename" - file to edit.  Drive and directory may be specified.  If 
  160.     no name is given, you begin a new (untitled) file.  If multiple names (up 
  161.     to 6) are given, they must have commas between them.
  162.          "/m" or " m" - optional choice of file modes: "m" can be "W"ordstar 
  163.     document, WordStar "5" document, "A"SCII document, or "N"ondocument.  
  164.     Normally defaults to "A".  Must be separated from filename by a space 
  165.     and/or a slash.  For further information see FILE MODES.
  166.          ";name.VDK (or VDF)" - optional macro and/or function key definition 
  167.     file to load.  Must appear after a semicolon, at the end of the command 
  168.     line.  For further information see KEY DEFINITION FILES.
  169.  
  170.      VDE can edit different types of files: nondocuments, such as program 
  171. source code, or documents with formatted text.  Further, for documents you can 
  172. choose either pure ASCII or WordStar (3.3/4.0, or 5.0) format.  If an existing 
  173. file is too large to edit with VDE, divide it up (see SPLITTING FILES).
  174.  
  175.      VDE gives you a certain amount of information at the top of the screen 
  176. (for details see HEADER, RULER).  If you type ^J, you can get a series of help 
  177. menus for the various VDE commands.  The menus, like all command prompts and 
  178. error messages, appear temporarily in the top portion of the screen; press 
  179. Esc, Space, or ^U to remove them.
  180.  
  181.      The VDE command set uses simple one- or two-key combinations, easily 
  182. found by the touch typist without distraction.  Most commands are the same as 
  183. in WordStar, the single most widely used word processor; if you have questions 
  184. that this file can't answer, a WordStar manual may be a useful reference.  
  185. But VDE is its own program, not a WordStar "clone"; there are significant 
  186. differences.  Most important, VDE has a number of extra Alt-key and Esc-key 
  187. commands to invoke its additional functions, such as multi-file editing.
  188.  
  189.  
  190.  
  191. ===========================  2. COMMAND SUMMARY  =============================
  192.  
  193.  
  194.      Explanation of Keys:  IBM PC special keys are indicated in [brackets], 
  195. including arrows "^,v,<,>" for the cursor keys.  "Esc" means the Escape key, 
  196. [Esc].  "Alt-" indicates holding down the [Alt] key: "Alt-D" means [Alt]+D.  
  197. The "^" character indicates holding down the [Ctrl] key: "^K" means [Ctrl]+K.  
  198. Many commands require two-key sequences, eg ^QR = [Ctrl]+Q,R; whether you hold 
  199. down [Ctrl] on the second key as well doesn't matter.  The prefix (^Q) 
  200. displays in the header, and can be canceled by pressing Esc or Space.
  201.      Synonyms:  If your keyboard lacks the IBM PC keys, synonyms are always 
  202. available (eg, ^R for [PgUp]).  If you have no [Alt] key, you can still access 
  203. the Alt-commands with a double-Esc prefix: Esc,Esc,X = Alt-X.
  204.  
  205.      Many VDE commands are identical to those in WordStar.  Equal signs ("=") 
  206. flag those that differ from their WordStar equivalents.  (See COMPATIBILITY, 
  207. below.)  Asterisks ("*") mark additional commands unique to VDE.
  208.  
  209.  
  210. I. WORDSTAR CONTROL KEYS:  single keystroke commands.
  211.  
  212.      ^J = Display Help menu.
  213.  
  214.      CR [ENTER] = Carriage Return (^M).  In documents, marks a paragraph end.
  215.      BS [<--]   = BackSpace (^H).  [May also delete.]
  216.     TAB = Hard Tab mode: Tab (^I).  Variable Tab mode: move to next stop.
  217.  
  218.      Arrow keys:  [^], [v], [>], [<] (IBM cursor keys).
  219.                   Or, WordStar: ^E up, ^X down, ^D right, ^S left.
  220.  
  221.      ^F or [^>]  = move to start of next word right.
  222.      ^A or [^<]  = move to start of previous word (left).
  223.  
  224.      ^W or [-] = scroll back one line.
  225.      ^Z or [+] = scroll forward one line.
  226.      ^R or [PgUp] = scroll back one screen.
  227.      ^C or [PgDn] = scroll forward one screen.
  228. *    [^PgUp] = scroll both files back a screen (in split screen mode).
  229. *    [^PgDn] = scroll both files forward (").
  230.  
  231.      ^G = delete character to the right of the cursor.
  232.   [Del] = delete character to the left.  [May instead delete right.]
  233.      ^T = delete word to right of cursor.
  234.      ^Y = delete current line.
  235.      ^U = undo last deletion (character, word, line, or block).
  236.  
  237.      ^V or [Ins] = toggle INSERT mode on and off.
  238.      ^N = insert a carriage return (break line) at present position.
  239. *    ^_ = insert a space to the right of the cursor.
  240. *    ^^ = toggle case (upper/lower) of character at cursor.
  241.      ^P = insert following control code in text.  Special cases:
  242.              ^PH = overstrike; ^PI = hard tab; ^PL = page break (formfeed).
  243. *            ^P# = insert automatic numbering marker.
  244.      ^B = reformat current paragraph.
  245.      ^L = repeat find/replace (Repeats last ^QF or ^QA command.)
  246.  
  247.  
  248. II. WORDSTAR FILE AND BLOCK COMMANDS:  first hit ^K, then the key shown.
  249.  
  250. *    ^K I = display file/memory Information message.
  251.  
  252.      ^K F = list Files on disk.
  253. =    ^K E = Erase a disk file.
  254.  
  255. *    ^K L = Load a new file to begin editing.
  256. *    ^K N = change the current file Name (affects Save, eXit).
  257.      ^K S = Save the current file to disk, and continue editing.
  258.      ^K D = Done.  Save the file, then load a new one.
  259.      ^K X = eXit.  Save the file, then Quit to DOS.
  260.      ^K Q = Quit to DOS, abandoning current file.
  261.  
  262.      ^K R = Read a disk file into text at cursor position.
  263.      ^K P = Print the text (whole file or block).
  264.  
  265.      ^K B = mark the start of a Block.
  266.      ^K K = mark the end of a block.
  267. *    ^K U = Unmark the block.
  268.      ^K Y = Delete the marked block.
  269.      ^K C = Copy the marked block at present cursor position.
  270.      ^K V = moVe the text in the block to present position.
  271.      ^K W = Write the marked block to a disk file.
  272.  
  273. *    ^K Z = Zoom into the marked block.
  274.      ^K ",' = uppercase (") or lowercase (') text in the block.
  275. *    ^K # = automatically number items in the block.
  276.  
  277.  
  278. III.  WORDSTAR QUICK COMMANDS:  first hit ^Q, then the key shown.
  279.  
  280.      ^Q S or ^Q[<] = go to start of line.
  281.      ^Q D or ^Q[>] = go to end of line.
  282.      ^Q E or [Home] = go to top of screen.    [Home, End keys can also be set
  283.      ^Q X or [End]  = go to bottom of screen.       to ^QS,^QD instead.]
  284.  
  285.      ^Q R or [^Home] = move to top of file.
  286.      ^Q C or [^End]  = move to end of file.
  287.      ^Q B = move to block start marker.
  288.      ^Q K = move to block end marker.
  289. =    ^Q Z = move to next place marker.
  290.      ^Q I = move to specified page (document) or line (nondocument).
  291.      ^Q P = move to previous position in file (before last command).
  292.  
  293.      ^Q F = find next occurrence of a string.
  294.      ^Q A = find and replace a string.
  295.  
  296.      ^Q Y = delete from cursor to end of current line.
  297.      ^Q [Del] = delete from cursor to beginning of current line.
  298.      ^Q T = delete up to specified character.
  299.  
  300.  
  301. IV. WORDSTAR ONSCREEN COMMANDS:  first hit ^O, then the key shown.
  302.  
  303. *    ^O E or ^O[^] = make current line top of screen.
  304.  
  305.      ^O R = set right margin (column 1 turns off wordwrap/formatting).
  306.      ^O L = set left margin.
  307.      ^O X = toggle Margin Release on/off.
  308.      ^O C = center current line.
  309. *    ^O F = align current line flush with the right margin.
  310.  
  311. *    ^O Q = toggle display of header.
  312.      ^O T = toggle display of ruler line.
  313.      ^O B = toggle display of hard CRs.
  314.      ^O D = preview text with no control codes or hard CRs.
  315.  
  316.      ^O A = toggle Auto Indent on/off.
  317.      ^O S = toggle Double Spacing on/off.
  318.      ^O H = toggle hyphenation on/off.
  319.      ^O V = toggle tab mode Hard/Variable.
  320.      ^O I = set variable tab stop(s).
  321.      ^O N = clear variable tab stop(s).
  322.  
  323. *    ^O P = set page length (0 turns off pagination).
  324. *    ^O W = toggle single-file text windowing on/off.
  325. *    ^O Z = temporarily blank the entire screen.
  326.  
  327.  
  328. V. VDE ALT-KEY COMMANDS: press Alt and the key shown.
  329.      (These commands also work with an Esc,Esc prefix instead)
  330.  
  331. *    Alt-L = Load an additional file to edit.
  332. *    Alt-K = change memory allocation for current file.
  333. *    Alt-B = move Back to the previous file being edited.
  334. *    Alt-N = move to the Next file being edited.
  335. *    Alt-W = split Window between two files.
  336. *    Alt-F = move to the File in the other window.
  337.  
  338. *  Alt-C,P = Cut and Paste a block from one place or file to another.
  339. *    Alt-M = Match up the two files on screen, showing differences.
  340. *    Alt-X = eXit (^KX) from all files, saving changes.
  341. *    Alt-Q = Quit (^KQ) from all files.
  342.  
  343. *    Alt-R = Run an MSDOS command (or SHELL).
  344. *    Alt-S = Split a huge file into pieces for editing.
  345.  
  346. *    Alt-T = enter the current system Time in the file.
  347. *    Alt-D = enter the current system Date in the file.
  348.  
  349. *    Alt-G = enter an IBM Graphics character into text.
  350. *    Alt-E = EGA screen mode.  Toggles between 25 and 43/50 lines.
  351. *    Alt-A = ATI screen mode.  Toggles between 80 and 132 columns.
  352.  
  353. *    Alt-O = move through file with Overview bar.
  354. *    Alt-V = change Printer drivers.
  355. *    Alt-U = Use another set of macro/function key definitions.
  356. *    Alt-I = display VDE Information message.
  357.  
  358.  
  359. VI. VDE ESC-KEY COMMANDS:  first hit Esc, then the key shown.
  360.  
  361. *    Esc TAB = backwards (leftward) tab.
  362. *    Esc [<],[>] = shift screen horizontally 32 columns.
  363. *    Esc [^],[v] = shift screen vertically 1/4 screen.
  364.  
  365. *    Esc [       = execute a Macro string of commands.
  366. *    Esc ]       = store macro on numeric key for later recall.
  367. *    Esc 0..Z    = use stored key.  (In macro mode: jump label.)
  368. *    Esc !,=,~   = jumps and loops, used in Macro programming (see MACROS).
  369. *    Esc (),+,-  = counter, used in Macro programming.
  370. *    Esc ;       = brief pause, during Macro execution only.
  371. *    Esc &       = chain to another Macro.
  372.  
  373.  
  374.  
  375. ==========================  3. EDITING COMMANDS  =============================
  376.  
  377.  
  378. AUTO INDENT MODE (^OA) - The ^OA command toggles Auto Indent mode.  When ON, 
  379.     wordwrap or the RETURN key will cause the cursor to advance to:
  380.          Any existing indentation on the line (if INSERT is OFF); or,
  381.          The same indentation as the previous line (if INSERT is ON).
  382.     Thus, once you set the indentation level (with Space, BS, etc), VDE will 
  383.     automatically maintain it.  This can be used as a paragraph indent in 
  384.     documents, or for typing outlines, structured program source code, etc.
  385.  
  386. AUTO NUMBER (^P#,^K#) - The ^P# command inserts a marker (a highlighted "#") 
  387.     in the text to stand for a sequential number in a list, for example:
  388.              #.  First item.
  389.              #.  Second item...
  390.     You can then mark the list off as a block (see BLOCK COMMANDS), and use 
  391.     the ^K# command: VDE will insert the numbers (1, 2, etc) in place of the 
  392.     markers.  You will be asked for the starting number; the default is of 
  393.     course 1.  (Once this is done the markers disappear.  For frequently 
  394.     revised lists, leave the "#" markers in the file on disk.  Run ^K# just 
  395.     before printing, and do not save afterward.)
  396.  
  397. BLOCK COMMANDS (^K-B,K,U,Z,Y,C,V,W,PB; ^QB,K) - A Block of text is delimited 
  398.     by two markers, which remain in memory until reset or deleted.  ^KB marks 
  399.     the beginning of the block; ^KK marks the end.  On IBM PCs, text in a 
  400.     marked block is displayed in a contrasting color.
  401.          ^KU unmarks the block, removing any marker(s) set.  (Block markers 
  402.     can also be deleted individually like ordinary characters.)  Markers are 
  403.     automatically removed as appropriate when ^KB/K are used again.
  404.  
  405.          The Block operation commands all require a block to be marked:
  406.          ^KZ "zooms into" a block: the rest of the text is hidden, and the 
  407.     block is temporarily treated as the entire file.  This can serve a number 
  408.     of purposes, from simply concentrating attention on one portion of a text, 
  409.     to limiting the scope of many VDE commands (^QA, ^B, ^KI, etc).  Use ^KZ 
  410.     again to zoom back out.  Commands that cannot be used when ^KZ is in 
  411.     effect include: Alt-K, ^OP.  (You can use block operations within the 
  412.     block, though any markers will disappear when zooming back out.)  If you 
  413.     save (^KS), VDE will automatically zoom back out of the block.
  414.          ^KY goes to and deletes the block (including markers).
  415.          ^KV moves the marked block text to the present cursor location; ^KC 
  416.     simply copies it, leaving the original marked.  Any place markers present 
  417.     are not transferred.  The cursor cannot be IN the block.
  418.          ^KW writes the block text to a disk file; you will be asked for the 
  419.     filename (and optional mode).  Normally this will overwrite any pre- 
  420.     existing file; however, you can choose instead to append the text at the 
  421.     end of the file, by typing a "+" before the filename:
  422.                   Write to file: GORT        overwrites
  423.                                  +GORT       appends
  424.          ^KPB (^KP with B option) prints the block text only.  (See PRINTING 
  425.     for further details.)
  426.          The ^QB command, from wherever you are in the file, moves the cursor 
  427.     to the block start; ^QK moves to the block end.
  428.  
  429. DELETING (^G,Del,^T,^Y; ^Q-Y,Del,T) -  You can delete text one CHARACTER 
  430.     at a time: ^G deletes to the right of the cursor, and [Del] to the left.  
  431.     Note that the ordinary BS (^H) does not normally delete.  [BS/DEL behavior 
  432.     can be changed with VINSTALL.]
  433.          ^T deletes an entire WORD to the right (up to 255 characters).
  434.          ^Y deletes the entire current LINE.  ^QY deletes the part of the 
  435.     line to the right of the cursor; ^Q-Del deletes the part to the left.
  436.          ^QT deletes UP TO the next occurrence of a specified character.  
  437.     Example: "^QT." deletes to the end of the sentence.  Special case: ^QT^M 
  438.     deletes to the next HARD CR, the end of the paragraph.
  439.          Accidentally deleted text can be recovered (see UNDELETE).
  440.  
  441. DISK OPERATIONS (^K-R,F,E) -  ^KR READS in the contents of a disk file, 
  442.     inserting the text after the current cursor position.  You will be asked 
  443.     for the name (and, optionally, mode) of the file.
  444.          ^KF lists disk FILES: you may specify a directory and/or filename 
  445.     mask, and the files will be alphabetically listed.  (The default is the 
  446.     directory specified with the current file, and all files *.*.)  Files 
  447.     display in uppercase; directories in lowercase.  If there is not enough 
  448.     room to fit all the items on the screen, you will see "..." at the end to 
  449.     indicate that there were still more.  Press Esc or Space to continue.
  450.          ^KE will ERASE a single disk file, if you need more room on the disk. 
  451.     (No wildcards allowed.)
  452.          If you need more complex file utilities than the ^KF/E commands 
  453.     provide, you can run any DOS command with Alt-R.
  454.  
  455. FILE COMMANDS (^K-N,S,X,D,Q,L) - ^KN NAMES your work.  This allows you to 
  456.     change the filename in the header before saving.  (Accepts mode option; 
  457.     you can also specify a mode alone, eg "/W", to change the current mode.)
  458.          ^KS SAVES your work: what's in memory is written to disk under the 
  459.     file name in the header.  (You must have a file name; one will be 
  460.     requested if necessary.)  If that file already existed, a backup (BAK) 
  461.     file may be preserved.  If the file has not been modified, you will be 
  462.     prompted to confirm that you want to resave it anyway.
  463.          There are several different commands for finishing up:
  464.          ^KX saves your work and then EXITS to DOS.
  465.          ^KQ just QUITS.  If the file has been modified, you will be prompted 
  466.     to confirm that you want to abandon the changes.
  467.          ^KD (DONE) saves your work, then loads a new file to edit.
  468.          ^KL quits the current file and LOADS a new one to begin editing.
  469.  
  470. FIND/REPLACE (^Q-F,A; ^L) -  ^QF is the command to FIND a string.  The 
  471.     search normally proceeds from the cursor position forward, and is case 
  472.     (upper/lower) sensitive.  The character "_" [this can be reconfigured], 
  473.     unless at the start of the string, functions as a wildcard: it will match 
  474.     any single character.  Control codes, like ^M for newline, can be included 
  475.     (with the ^P prefix where needed).  Examples:
  476.            Find: ^MLABEL       matches "LABEL" at start of line only;
  477.            Find: 4__01         matches "42201", "47401", etc;
  478.            Find: _             matches "_".
  479.         ^QA is the REPLACE command.  It asks for a string to find, then what 
  480.     to change it to.  The cursor will be placed in succession on each 
  481.     occurrence of the string, starting at the cursor location.  (You will see 
  482.     the prompt "Chg?" in the header.)  To change this instance, press "Y";  
  483.     anything else skips to the next.  To change all further instances without 
  484.     being asked, press "*".  Esc cancels at any time.
  485.          There are several OPTIONS for find/replace.  After you enter the text 
  486.     string(s), you will be prompted to enter any of the following:
  487.            "B" = search Backward through the file
  488.            "U" = ignore Upper/lower case distinctions
  489.            "G" = search Globally (from start or end of file)
  490.     and further, for replacing:
  491.            "A" = Align paragraphs again after each replacement
  492.            "N" = No query: replace all instances without asking
  493.     If you don't wish to be prompted for options, finish entry of the find 
  494.     string (for ^QF) or replace string (for ^QA) by typing ^J instead of 
  495.     RETURN.  (This is also ^RETURN on most keyboards.)
  496.          Notes:  The "N" option is automatically assumed whenever ^QA is used 
  497.     in a Macro.  [Uppercase can be set as your default; if so, specifying 
  498.     "U" reverts to case sensitive search.]
  499.          ^L repeats the last ^QF or ^QA command.  For ^QA, you will be asked 
  500.     whether you want to replace the found string.  In both cases, the "B", 
  501.     "U", and "A" options remain as last specified.
  502.  
  503. GRAPHICS (Alt-G) -  You can enter an IBM graphic character into a VDE file 
  504.     with the Alt-G command.  You will be presented with a menu of up to 32 
  505.     characters (A-Z,1-6) to choose from; the default set contains some nice 
  506.     box parts and other useful things, and has some room free for other 
  507.     characters that might be loaded.  [The default set can be modified using 
  508.     VINSTALL.]
  509.          If you type "=", you can change a menu entry.  Type the code (A-5) to 
  510.     change, then type the extended character directly using the numeric keypad.  
  511.     (Example: a Greek alpha is 224; press and hold Alt, type 2-2-4, release 
  512.     Alt.)  
  513.          You can also type "-" to clear the whole set, if you need room to 
  514.     load a file with other graphics.
  515.          VDE is limited to this displayed set of 32 of the possible 127 
  516.     characters (ASCII 80-FE) at a time.  There is no way to enter a character 
  517.     outside of this set from the keyboard.  If you load a file containing 
  518.     other graphics characters, VDE will automatically try to add them to the 
  519.     current set.  CAUTION: If there is no room, they will be replaced by a 
  520.     grey blob (graphic #6)!  If you wish to leave the graphics set completely 
  521.     empty, or clear them with Alt-G-"-", they will simply adapt as a file is 
  522.     loaded.
  523.          Graphics are sent to the screen as extended ASCII codes 80-FE.  If 
  524.     you don't have an IBM compatible PC, they may not be distinguishable from 
  525.     ordinary characters.  They are stored in disk files directly as extended 
  526.     ASCII codes.  (Exception: in "W" or "5" mode, IBM graphics in disk files 
  527.     are handled compatibly with WordStar 4 and 5.)
  528.          Printing of graphics depends on whether your printer is installed as 
  529.     an IBM graphics printer [see VINSTALL].  If so, they will print directly.  
  530.     If not, VDE will "emulate" them, choosing standard ASCII character 
  531.     combinations that come as close as possible.  This usually works really 
  532.     well, especially for all the foreign characters -- try it out!
  533.          It is also possible for a file to contain graphics in the ASCII 00-1F 
  534.     range, but many of these codes are used by VDE for other purposes, and 
  535.     cannot be interpreted as graphics.  If a code has no reserved use, and is 
  536.     not installed as a print toggle or switch, it will function as a graphic.
  537.  
  538. HEADER (^OQ) -  Normally VDE gives you a "header", or status line, at the top 
  539.     of the screen.  If you like, you can toggle this display on and off with 
  540.     the ^OQ (Quiet) command.  [It can also be suppressed by default.]  Turning 
  541.     the header off lets you see more text, and can improve speed on slow 
  542.     terminals.
  543.     -----------------------------------------------------------------------
  544.     *C:VDE.DOC  /A        Pg 7   Ln 55   Cl 48   INS   vt hy AI DS MR  ^K_
  545.     -----------------------------------------------------------------------
  546.          "*" = Multi-file flag.  If present, other file(s) are being edited.
  547.          "C:VDE.DOC /A" = Current file name and mode.  Any directory that was 
  548.     specified is the active default, although it does not display.
  549.          "Pg 7, etc" = Current position in file by page (in document modes), 
  550.     line, column.  If pagination (^OP) is off, you will see "Pg 0" (in 
  551.     document modes), "OP" (in "N" mode), or "BZ" if ^KZ is in effect.
  552.          "INS" = Insert mode on. (^V)
  553.          "vt" = Variable Tab mode on. (^OV)
  554.          "hy" = Hyphenation enabled. (^OH)  Doesn't display in "N" mode.
  555.          "AI" = Auto Indent mode on. (^OA)
  556.          "DS" = Double spacing. (^OS)
  557.          "MR" = Margins released. (^OX)  Doesn't display in "N" mode.
  558.          "^K"... Key prefixes (and some prompts) display here.
  559.  
  560. HYPHENATION (^OH) -  VDE can't introduce hyphens, but it does recognize them 
  561.     in the text, treating them as a legitimate place to break a line.  (So if 
  562.     you have a long word close to the margin, you can insert a hyphen where 
  563.     you'd like the word to be broken.)
  564.          Similarly, VDE can't dehyphenate.  If it is trying to reformat and 
  565.     finds a hyphen at the end of a line, it will pause to ask you what to do 
  566.     with it.  You will see the prompt "Remove?" in the header, and can:
  567.         Press "Y" to remove the hyphen and space, joining the word;
  568.               "N" to leave the hyphen but still join the word;
  569.             "Esc" to leave both the hyphen and space alone.
  570.     Typically you would choose "Y" for "soft" hyphens that you introduced to 
  571.     break up a word ("intro-duction"); "N" for hard hyphens that are part of a 
  572.     word ("vis-a-vis"); and "Esc" for punctuation (dashes -- etc).  After your 
  573.     choice, reformatting will proceed automatically.
  574.          You can toggle hyphenation on and off with ^OH.  If off, hyphens are 
  575.     not treated differently from any other text character.  [The ^OH default 
  576.     can be changed with VINSTALL.]
  577.  
  578. INFORMATION (^KI; Alt-I) -  ^KI displays an Information message telling you:
  579.               * whether (Y/N) the file has been changed since last saved;
  580.               * a word count for documents (useful for professional writing);
  581.               * the current size of the file in K (1K = 1024 bytes);
  582.               * the approximate size of the text memory in K;
  583.               * the number of bytes of text memory used and free.
  584.          For large files, all this may take a moment to calculate.  Note that 
  585.     words are not counted in nondocuments.  For further explanation, see 
  586.     MEMORY.
  587.          Alt-I displays the VDE version, date, and usage policy.  (An unin- 
  588.     stalled copy of VDE does this automatically on startup.)
  589.  
  590. INSERTION (^V,^_,^N) -  ^V (or [Ins]) toggles insertion on and off.  If INSERT 
  591.     is OFF, any text to the right of the cursor is overwritten as you type.  
  592.     If INSERT is ON, what you type is inserted, and existing text moves to the 
  593.     right.  (When INSERT is OFF, you can still insert a space with ^_, or a 
  594.     carriage return with ^N.)
  595.  
  596. LINE SPACING (^OS) -  The ^OS command toggles between single and double line 
  597.     spacing.  In double space mode, the following functions generate double 
  598.     carriage returns:  CR (^M), Insert CR (^N), Reform (^B), Wordwrap.  You 
  599.     can easily mix single and double spacing; the ^B command can convert 
  600.     between the two.
  601.          Note: if you prefer to keep your actual file single spaced, you can 
  602.     still get a double-spaced printout by using the "D" option of the ^KP 
  603.     command (see PRINTING).
  604.  
  605. MARGINS (^O-R,L,X,C,F) - ^OR sets the RIGHT margin, and enables wordwrap, 
  606.     reformatting, and centering.  At the prompt "Column:" enter the column 
  607.     number (2-255), or just hit CR for the current cursor column.  If the 
  608.     value entered conflicts with the current left margin, the left margin will 
  609.     be removed.  There are two special values for the right margin:
  610.       1 = all formatting is disabled (as in "N"ondocument mode files).
  611.       0 = unlimited right margin: every paragraph becomes one line.
  612.          ^OL sets the LEFT margin in an identical fashion; of course, the 
  613.     value must always be less than the current right margin, meaning it's best 
  614.     to set the right margin first.
  615.          ^OX temporarily RELEASES the margins (resets them to 1), allowing you 
  616.     to type outside them.  Use ^OX again to restore the margins.
  617.          ^OC CENTERS the current line with respect to the margins, if set.  
  618.          ^OF sets the current line FLUSH right, if the right margin is set.
  619.     See also RULER LINE.
  620.  
  621. MATCHING UP FILES (Alt-M) -  The Alt-M command is used to Match up two files: 
  622.     starting from the current cursor lines, VDE searches for any difference 
  623.     between the files.  If there is a difference, VDE will stop on those 
  624.     lines, showing the disagreeing passages side by side!  This is ideal for 
  625.     locating revisions by comparison with an earlier draft.  If the files 
  626.     match completely, VDE will report "Not Found".
  627.          (Note: before using Alt-M you must split the screen window (Alt-W) 
  628.     between the two files to be matched, and position the cursor on 
  629.     corresponding lines in both files.)
  630.  
  631. MOVING AROUND (Arrow keys; ^F,^A; ^Q-R,C,I,P; Alt-O) -  VDE supports two sets 
  632.     of Arrow keys, which function interchangeably.  The first is the actual 
  633.     IBM cursor keypad (the four arrow keys); the second is the WordStar "arrow 
  634.     key diamond" ^E,^X,^D,^S.  These keys move the cursor up, down, right, and 
  635.     left respectively.
  636.          Preceded by ^Q-, any arrow key moves more quickly: to the top or 
  637.     bottom of the screen, to the left or right end of the line.
  638.          There are also two word movement commands: ^F moves right, to the 
  639.     start of the next word; ^A moves left, to the start of the last (or 
  640.     current) word.  Both have a maximum movement of 255 characters.
  641.          For quickly covering large distances, the commands ^QR and ^QC move 
  642.     all the way to the beginning and end of the file, respectively; ^QI moves 
  643.     directly to a given page (for documents) or line (for non-documents).  The 
  644.     ^QP command returns the cursor to its previous position -- before the last 
  645.     command causing a large movement was executed.  (^QP can be used again to 
  646.     cycle between the two positions in the file.)
  647.          Finally, the Alt-O command displays an "overview bar" at the top of 
  648.     the screen.  Its extent shows the file size, and the current position is 
  649.     marked so you can see where you are in the file:
  650.                C:MODERATE.FIL  /A    Pg 5  Ln 12  Cl 1    INS
  651.               ooooooooo*ooooooooooooooooo
  652.     You can move to any position in the file by moving the marker left or 
  653.     right, then hitting RETURN.  (Press Esc instead to cancel.)  If the file 
  654.     is too small, Alt-O does nothing.
  655.  
  656. MULTIPLE FILES (Alt-L,B,N,K,X,Q,C,P) -  VDE allows you to edit up to six diff- 
  657.     erent files simultaneously, if you have enough memory.  This can be done 
  658.     from the command line, by giving the filenames separated by commas.
  659.          Otherwise, to Load an additional file, you press Alt-L.  Note the 
  660.     flag "*" appearing in column 1 of the header, by the name: this means that 
  661.     a second edit is in progress.  (This command may fail if you run out of 
  662.     memory, or are already editing six files.)
  663.          Once multiple files are in use, the Alt-B and Alt-N commands can be 
  664.     used to cycle back and forth through the files being edited.  If you Quit 
  665.     or Exit (^KQ,^KX) from one file, you will be returned to another one, 
  666.     rather than to DOS.
  667.          The Alt-K command can be used to adjust the amount of memory 
  668.     allocated by VDE to edit the file (normally 64k).  Decreasing this for 
  669.     small files will allow you to edit more files on systems with limited 
  670.     amounts of memory.
  671.          The Alt-X command exits ALL files immediately, saving any changes.  
  672.     The Alt-Q command quits ALL files immediately.  Unlike ^KS/^KQ, neither 
  673.     one ever prompts for any confirmation.
  674.          The Alt-C command Cuts a marked block of text, placing it in a buffer 
  675.     for later use with the Paste command.  (The original remains, unless you  
  676.     delete it with ^KY.)
  677.          The Alt-P command Pastes in previously cut text at the cursor 
  678.     position.  The text in the buffer remains available for further pasting.  
  679.     (Cut and Paste thus allow block copying and moving between files.)
  680.  
  681. PAGINATION (^OP; ^PL) -  The ^OP command sets the page length.  Enter a value 
  682.     from 0 to 255, or just hit CR to restore the default value.  [Normally 56.]
  683.          When the value is nonzero, it determines the page and line shown in 
  684.     the document header ("Pg xx Ln xx"), and all page functions in the Print 
  685.     routine (pagination, headers, start/stop at page) are enabled.  A formfeed 
  686.     will be sent after printing.  (VDE does not send a formfeed before 
  687.     printing; install one in your printer initialization if you want.)
  688.          When the value is zero, pagination is off.  The header will say "Pg 0 
  689.     Ln xxxx", showing you the absolute line number in the file.  Also, 
  690.     printing occurs with no page breaks.  (This is useful for printing small 
  691.     things right after each other on the same sheet; or, in conjunction with 
  692.     the "*" option, can print out multiple copies of index cards, labels, etc.)
  693.          The ^PL command embeds a formfeed (^L) in the text.  This code 
  694.     functions as a page break: you can type ^PL at the start of a line to 
  695.     begin a new page.  In document ("A,W,5") file modes, this will be 
  696.     reflected in the header page/line count, use of ^QI and other page-related 
  697.     commands, etc; it does not affect line count in "N"on-documents, or when 
  698.     pagination is off (^OP 0).
  699.          Moving around in a large file is a little quicker in "N" mode, or 
  700.     with pagination off (^OP 0), as pagebreaks don't need to be recalculated.  
  701.     This is so for this file (VDE.DOC), which contains several formfeeds.
  702.  
  703. PLACE MARKERS (^PZ; ^QZ) -  You can set any number of temporary place markers 
  704.     in the text with ^PZ (they will appear as ^Z).  The ^QZ command moves the 
  705.     cursor to the next place marker in the file, cycling back to the top of 
  706.     the file as needed.  (Place markers are NOT saved to disk.)
  707.  
  708. PRINTER CODES (^P) -  Control codes for special effects in printing can be 
  709.     entered in the text with the ^P prefix.  Thus pressing ^P^H (or ^PH) 
  710.     embeds a ^H, etc.  Several standard codes are:
  711.           ^H - backspace - overstrike previous character
  712.           ^I - hard (ASCII) tab - printers respond variously to this
  713.           ^L - formfeed (page break)
  714.     (^Z is reserved for use as a place marker.)  Control codes display on 
  715.     screen as capital letters, highlighted if possible.  VDE assumes they are 
  716.     not characters, so they are not counted when reformatting text.
  717.          You can only embed certain standard ASCII codes with ^P.  (IBM 
  718.     extended characters 80-FF must be entered with Alt-G; see GRAPHICS.)
  719.          You could try to enter the actual Esc-commands your printer requires, 
  720.     each time they were needed.  (If you do take this approach, be sure that 
  721.     none of the bytes involved is installed as one of the 12 VDE printer 
  722.     features described below, which invoke a defined string rather than 
  723.     printing out directly themselves.)
  724.          But the recommended (and more convenient) approach arranges to have a 
  725.     single ^P-code produce an entire string of bytes for commonly used 
  726.     effects.  VDE supports a subset of WordStar's printer installation, up to 
  727.     12 definable codes: six toggles, six switches.  The Printer Installation 
  728.     in VINSTALL allows you to install the actual control sequences your 
  729.     printer needs.  The conventional WordStar assignments are:
  730.          Toggles: ^B  boldface        Switches: ^Q  (user 1)
  731.                   ^D  doublestrike              ^W  (user 2)
  732.                   ^S  underline                 ^E  (user 3)
  733.                   ^Y  italic ("ribbon")         ^R  (user 4)
  734.                   ^T  superscript               ^A  alternate pitch
  735.                   ^V  subscript                 ^N  standard pitch
  736.     but you can make them do anything you like.  "Toggles" are good for 
  737.     features like underline that are turned on and off.  "Switches" are better 
  738.     for multi-valued parameters like character pitch.
  739.          Example: your printer uses Esc-U-01 (and 00) to turn underlining on 
  740.     (and off).  Rather than trying to embed those actual codes in your file, 
  741.     you can just type ^PS wherever you want
  742.                          ^PSunderlined text^PS,
  743.     and install the ^S toggle for the appropriate codes [see VINSTALL.DOC].
  744.  
  745. PRINTER DRIVERS (Alt-V) -  Since many people use more than one kind of 
  746.     printer, VDE accomodates two different printer drivers, a primary and an 
  747.     alternate.  Before printing a file, you can select which one is active 
  748.     using the Alt-V command.  [You can set up the code definitions for each 
  749.     one with VINSTALL.]
  750.  
  751. PRINTING (^KP) -  The ^KP command Prints the file from memory.  You will be 
  752.     asked for a set of "Options:", at which point you may enter one or more of 
  753.     the following, in any order:
  754.        D      DOUBLESPACES the printout.
  755.        P      PAUSES for your keystroke before each page (sheet feed).
  756.        B      prints only the currently marked BLOCK.
  757.        Tnn    sets the TOP MARGIN to nn lines.      [The default margins can
  758.        Lnn    sets the LEFT MARGIN to nn columns.    be set with VINSTALL.]
  759.        ^      FILTERS control characters ^X to text "^X".
  760.        *nn    prints the job out nn TIMES (nn=1..255).
  761.  
  762.        @nn    begins printing AT page nn.
  763.        #nn    prints only (up to) a TOTAL of nn pages.
  764.        =nn    begins page NUMBERING at nn.
  765.        "..."  uses the quoted string as a HEADER.  The string, followed 
  766.             immediately by the page number, will print at the top right of 
  767.             each page near the margin.  (Maximum length is 50 characters; 
  768.             an empty string, "", gives numbered pages with no header text.)
  769.               Note: you can include the current Time or Date in the header 
  770.             simply by pressing ^T or ^D, respectively.
  771.  
  772.          The last four options (@,#,=,"") are NOT allowed if the page length 
  773.     (^OP) is set to 0, or if "B"lock print was chosen.
  774.           Example 1:      Options:  L12P
  775.     will print the file with a left margin of 12, pausing before each page 
  776.     until you press a key (other than Esc).
  777.           Example 2:      Options:  @6#2=21"(^T) Instructions, page "
  778.     will print the 6th and 7th pages, numbering them 21 and 22, with a header 
  779.     like this:    (03:41 PM) Instructions, page 21
  780.           Example 3:      Options:  BD^*2
  781.     will print out the current marked Block, double spaced, with control 
  782.     filtering, twice.
  783.          NOTE:  If you are in "W" or "5" file mode, any dot commands in the 
  784.     file (lines beginning with ".") will not be printed.
  785.          You can abort printing at any time by pressing Esc.
  786.  
  787.          It is also possible to redirect printer output to a disk file.  All 
  788.     print control codes will go into the file just as they would have been 
  789.     sent to your printer; the file can be examined, or printed out later using 
  790.     COPY to PRN.
  791.          At the "Options:" prompt, just type the filename, in (parentheses).  
  792.     Any pre-existing file will be overwritten; if you want to append to an 
  793.     existing file, type a "+" before the filename.
  794.           Example 3:      Options:  B(+SCRATCH.FIL)
  795.     will append the printer output from the current marked Block, to the disk 
  796.     file SCRATCH.FIL.
  797.  
  798. RULER LINE (^OT) -  To help you align text properly, ^OT displays a "ruler 
  799.     line" above the text.  Type ^OT again to remove it.  A moving pointer 
  800.     indicates the current column.
  801.          In each column you will see one of several symbols: "v" is the cursor 
  802.     column; "[]" designate the current margins; "." indicates areas outside 
  803.     the current margins, "-" within them.  Also, tab stops are marked by 
  804.     either "T" (Variable) or "I" (Hard).  Examples:
  805.         ("A" mode)      [-----T-----T--------v--T--------------]........
  806.         ("N" mode)      I.......I.......I....v..I.......I.......I.......
  807.  
  808. RUN COMMAND/SHELL (Alt-R) - Typing Alt-R gives you a prompt "DOS>", from 
  809.     which you can run any command or program just as you would under MSDOS.  
  810.     You can copy and rename files, or run any other program you like, and 
  811.     afterwards return to your undisturbed VDE editing session by pressing Esc 
  812.     or Space.  This is especially useful for programming: you can run your 
  813.     compiler without ever leaving the edit of the source file.  VDE leaves no 
  814.     disk files open, so you can do anything you like with an Alt-R command.  
  815.     (Exception: don't load new memory-resident utilities.)
  816.              In addition to standard DOS commands and programs, there is a 
  817.     special VDE command that can be typed at the "DOS>" prompt:  SHELL.  This 
  818.     lets you out into a full DOS Shell.  You will see the actual MSDOS prompt, 
  819.     and can use any number of commands, and generally move around in DOS as 
  820.     you like; to return to your undisturbed VDE editing session, type EXIT.
  821.          Note: For the Alt-R command to work, VDE must be able to find your 
  822.     command interpreter (usually COMMAND.COM), and there must be enough free 
  823.     memory to load it and run the chosen program.  VDE checks the COMSPEC 
  824.     environment variable.  If your CONFIG.SYS file doesn't include a line like
  825.                           SET COMSPEC=C:\COMMAND.COM
  826.     you should add one.  (This can improve performance of other programs too.)
  827.  
  828. SCREEN CONTROLS (^W,^Z; Esc-[^,v,<,>]; ^O-E,D,Z; Alt-E,A) -  VDE provides a 
  829.     number of commands affecting the screen display:
  830.          The ^W and ^Z commands (or the [-] and [+] keys) scroll the screen up 
  831.     and down a line at a time, without moving the cursor (unless necessary).
  832.          Preceded by Esc-, any arrow key shifts the SCREEN, leaving the cursor 
  833.     in place: the text as a whole moves up/down 1/4 screen, or right/left 32 
  834.     columns.  (The cursor must be past column 32 to allow horizontal shifts.)
  835.          Preceded by ^O-, either UP arrow key (eg, ^OE) makes the current text 
  836.     line the top of the screen.
  837.          The ^OD command shows you a preview of the screen with all non- 
  838.     printing codes (markers, ^P codes, etc) hidden.  This is handy for making 
  839.     sure that text is aligned properly.  Press ESC to continue editing.
  840.          The ^OZ command temporarily "zaps" (blanks) the entire screen; good 
  841.     for avoiding CRT burn-in, or just protecting work from prying eyes or 
  842.     fingers.  Restore the screen by pressing Esc.  This is also useful if some 
  843.     other software (like resident utilities) has messed up the screen: type 
  844.     ^OZ,Esc and VDE will completely restore it.  (Note: on non-IBM computers, 
  845.     windows may not be restored.)
  846.          The Alt-E command lets you see more lines of text on screen, if you 
  847.     have an enhanced graphics adapter.  It toggles between normal 25-line 
  848.     mode and a compressed mode of 43 (EGA) or 50 (VGA) lines.  This command 
  849.     has no effect on systems without EGA/VGA.  [Note: compressed fonts can be 
  850.     hard to read.  You can choose a thin or fat font with VINSTALL.]
  851.          The Alt-A command works ONLY with the ATI EGA Wonder video card; do 
  852.     not use it otherwise.  (Many Kaypro PCs come with this card.)  This 
  853.     toggles between normal 80-column mode and ATI 132-column mode.  It can be 
  854.     used alone, or in combination with Alt-E to provide a 43x132 screen.
  855.  
  856. SPLITTING FILES (Alt-S) -  The upper size limit on files that VDE can edit is 
  857.     about 80K; if you try to edit a much larger file VDE will be unable to 
  858.     load it.  However, if you encounter a larger file that you need to work 
  859.     with, VDE makes it easy to divide a file into manageable chunks with the 
  860.     Split command.  Suppose you have a big file HUGE.DOC.  Type Alt-S, then 
  861.     answer at the prompt:
  862.            Split file, output name (w/#):  HUGE.DOC, PIECE.#
  863.     VDE will go through the file HUGE.DOC and write out a series of smaller 
  864.     files PIECE.1, PIECE.2 etc, which can then be edited.  (You can tidy up 
  865.     the transitions between them with block moves, if you like.)
  866.          Note that the output name must be separated from the input by a 
  867.     comma, and must contain one # sign, which will be replaced by a 1, 2, etc 
  868.     in order.  (The above example could have used HUGE#.DOC, HUGE.#, etc.)  
  869.     Make sure you have enough disk space for the output files.
  870.  
  871. TABS (TAB,Esc-TAB; ^O-V,I,N) -  There are two Tab modes, Variable and Hard; 
  872.     the ^OV command toggles between them.  In Hard Tab mode the Tab key 
  873.     produces an actual ^I (ASCII TAB); whether this overwrites any existing 
  874.     text depends on the INSERT toggle.  Hard Tabs display at fixed intervals 
  875.     of 8 screen columns.
  876.          In Variable Tab mode, the Tab key moves the cursor to the next 
  877.     variable tab stop.  Existing text is not overwritten; spaces are added at 
  878.     the end of a line as needed.  Up to eight tab stops may be set with ^OI 
  879.     and cleared with ^ON; the defaults are in columns 5, 15, 35, and 55.  
  880.     [These are reconfigurable.]  You can always get a Hard Tab by typing ^PI.
  881.          The set/clear commands prompt for a column number, or you can hit 
  882.     RETURN for the cursor column.  In addition, the Set command ^OI accepts 
  883.     two further options, both of which replace all earlier tab settings:
  884.               @nn           Set tabs every "nn" columns
  885.               #n1,n2,...    Set tabs to columns "n1,n2,..."
  886.     You can simply clear all variable tabs by typing "@" or "#" alone.
  887.          The Esc-TAB command is a backwards (left) tab, moving to the previous 
  888.     tab setting.  This is useful for moving around in tables, etc.
  889.          See also RULER LINE.
  890.  
  891. TIME/DATE (Alt-T,D) -  If your MSDOS system maintains the system clock 
  892.     properly, VDE can read it and insert the current time and date in your 
  893.     file automatically.  Just press Alt-T for the Time, or Alt-D for the Date.  
  894.     The string will appear at the current cursor location, as though you had 
  895.     typed it in yourself: for example,
  896.               1:21 PM            [or 13:21 -- see VINSTALL]
  897.               January 15, 1988   [or 1/15/88, 15 January 1988, 15.1.8]
  898.  
  899. UNDELETING (^U) -  The undelete function can be used to recover any text lost 
  900.     by the last deletion operation (whether character, word, line, or block).  
  901.     This includes an overstruck character.  The text will be replaced at the 
  902.     current cursor location.  ^U works only once.
  903.  
  904. UPPER/LOWER CASE (^^; ^K",') -  The command ^^ (Ctrl-caret or Ctrl-6) changes 
  905.     the case of the character at the cursor, if it was a letter, and moves to 
  906.     the next.  Useful for changing case of a few characters.
  907.          The ^K" command changes all text in a block to uppercase; ^K' changes 
  908.     it all to lowercase.  (Requires a block to be marked; see BLOCK COMMANDS.)
  909.  
  910. WINDOWS (^OW; Alt-W,F) -  VDE can split the screen into two windows, showing 
  911.     you either two parts of the same file or two different files.
  912.          The ^OW command creates a Window in the bottom half of the screen, 
  913.     which retains a copy of the file text starting at the current line; 
  914.     editing continues normally in the top half of the screen.  This lets you 
  915.     keep a passage in view while you do something else.  Typing ^OW again 
  916.     removes the Window.
  917.         The Alt-W command splits the screen Window between two DIFFERENT 
  918.     files; the Alt-F command allows you to move back and forth between them.  
  919.     Type Alt-W again to restore fullscreen editing.  When the window is split, 
  920.     a pair of special commands can scroll through BOTH files at once: [^PgUp] 
  921.     and [^PgDn].  (You can distinguish this split screen from a single-file 
  922.     (^OW) Window by the presence of full header information below.)
  923.  
  924. WORDWRAP & REFORMAT (^B, ^OB) -  WORDWRAP is automatic in Document modes 
  925.     ("A,W,5") whenever the right margin is set.  Any text entered will be 
  926.     formatted while you type, to the current margin settings.  The end of a 
  927.     paragraph is marked by a "HARD CR", which occurs when you press the RETURN 
  928.     key.  (This is a CR immediately following a character of text.)  In 
  929.     contrast, when wordwrap occurs you get a "SOFT CR" (which is actually a CR 
  930.     with a space before it).  You can change a hard CR into a soft one, or 
  931.     vice versa, by deleting or adding a space at the end of the line.  Hitting 
  932.     RETURN also hardens a soft CR.  The distinction between hard and soft CRs 
  933.     is only important when reformatting.
  934.          ^B REFORMATS from the line the cursor is on, to the end of the para- 
  935.     graph, according to the current margin settings and line spacing.  (Thus 
  936.     ^B is used not only to reshape a paragraph after editing, but also to 
  937.     change its margins and line spacing.)  Indentation can be tricky if you 
  938.     have a left margin set: if the current line is indented relative to the 
  939.     next one, VDE assumes that amount as your paragraph indentation.
  940.          ^OB toggles DISPLAY OF HARD CRs.  Hard CRs, otherwise invisible, are 
  941.     normally displayed as a left-arrow character in Document files.  [You can 
  942.     select dim video for these with VINSTALL.]  Some may find these 
  943.     distracting, so they can be turned off.
  944.  
  945.  
  946. ========================  4. MACRO AND FUNCTION KEYS  ========================
  947.  
  948.  
  949.      A "macro" is a string of VDE commands and/or text that you can type in 
  950. once and then have repeated automatically.  A "function key" is a macro 
  951. assigned to one of the [F1]..[F40] keys, while a "macro key" is a macro 
  952. assigned to a key Esc0..9 or EscA..Z; these can all be redefined from within 
  953. VDE.  "Macro programming" involves the use of special commands allowing a VDE 
  954. macro to perform more complex operations including loops and conditional 
  955. execution, much like a programming language.
  956.      VDE's 76 user-definable macros allow you to customize it for any task, 
  957. such as the formatting requirements of specialized professional writing, or 
  958. many programming languages.
  959.  
  960. FUNCTION KEYS ([F1]..[F40]) -  Up to 40 Macros can be assigned to function 
  961.     keys; they can then be recalled and used with one keystroke.  Each of the 
  962.     10 function keys can be used with Shift, Ctrl, or Alt, to produce:
  963.               Shift-[F1]...[F10]  =  [F11]...[F20]
  964.                Ctrl-[F1]...[F10]  =  [F21]...[F30]
  965.                 Alt-[F1]...[F10]  =  [F31]...[F40]
  966.     (Extended keyboards actually have keys labeled [F11] and [F12].  VDE will 
  967.     not recognize these keys.)
  968.          Otherwise, function keys are defined (with the Esc] command, or with 
  969.     VINSTALL) and used exactly like macro keys.  See MACRO KEYS.
  970.  
  971. KEY DEFINITION FILES (Alt-U) -  VINSTALL can create disk files of macro or 
  972.     function key definitions.  [For further details see VINST.DOC under 
  973.     FUNCTION KEYS.]  These should be given file types of ".VDK" and ".VDF", 
  974.     respectively, and can be loaded while using VDE in two ways: first, on the 
  975.     command line, with the use of a semicolon after the filename (see SYNTAX, 
  976.     above).  Second, the Alt-U command lets you load any of these while 
  977.     editing with VDE, to change from one entire set of definitions to another.  
  978.     You will be prompted for the filename (the type MUST be ".VDK" or ".VDF").
  979.  
  980. MACROS (Esc[) -  When you are in the middle of doing something in VDE, and 
  981.     find that you need to do something many times, it may be less tedious to 
  982.     have it repeated automatically.  If you type Esc[ you will be asked for 
  983.     the string to execute, then a "Repeat count".  Usually you will simply 
  984.     type a number for the repeat count (0-254, or "*" for indefinite).  You 
  985.     will see the results as the macro executes, and you can abort it at any 
  986.     time by pressing Esc.
  987.          (You can speed up Macro execution by specifying "Quiet" mode: type 
  988.     "^Q" before the repeat count.  Only the header will be updated as the 
  989.     Macro runs.  Don't do this if the macro requires user input -- the 
  990.     necessary prompts may not display!)
  991.          Macros also stop any time an error occurs; the error message will be 
  992.     visible, and can be cleared by pressing Esc.  Many commands (like Find or 
  993.     Reformat) are designed to generate errors at the end of the file so that 
  994.     an indefinite ("*") Macro containing them will halt there.  Other indef- 
  995.     inite Macros may need to be aborted manually.
  996.          VDE turns INSERT OFF before running a macro, so that the same 
  997.     sequence will always have the same effect.  The INSERT status is restored 
  998.     when the macro terminates.  (To insert text with a macro, use ^V!)
  999.          In order to include any input line editing characters (BS, CR etc) in 
  1000.     a macro, you must prefix them with ^P.  (NOTE:  To make them easier to 
  1001.     read and understand, Macro listings will be given here as they function, 
  1002.     not as they are typed in.  ^P prefixes as needed are NOT shown.  Key- 
  1003.     strokes are separated by dashes or commas for clarity, and "_" means a 
  1004.     space or blank.)  Here are some sample macros:
  1005.          1.  Reformat an entire file (Wordstar ^QQB): after Esc[, just enter
  1006.                                   ^B
  1007.     Specify quiet and indefinite repeat as options ("Q*").
  1008.          2.  View a file by scrolling slowly through it:
  1009.                                Esc;,^C
  1010.     This will pause, then scroll down.  (Use a repeat count of "*".)
  1011.          3.  Enter a long graphics border for a box.  (This can get tedious by 
  1012.     hand.)  Assuming graphic "Y" is the horizontal bar,
  1013.                                Alt-G,Y
  1014.     will enter one character.  You can get a line 40 characters long by giving 
  1015.     a repeat count of "^Q40" (the "^Q"uiet option avoids unnecessarily 
  1016.     displaying the menu).
  1017.          4.  Can you figure out what this one does?  (Answer:  .elif eht fo 
  1018.     dne eht ta meht fo tsil a gnikam elif a fo tuo sesehtnerap ni stnemmoc 
  1019.     ekat lliw tI)
  1020.                 ^QR,^QF,(,^J,^G,^KB,^QF,),^J,^G,^KK,^QC,CR,^KV
  1021.          VDE Macros are very powerful tools, particularly given their program 
  1022.     ability and storage on macro Keys.
  1023.  
  1024. MACRO KEYS (Esc],0..Z) -  Up to 36 Macros can be stored (0..9,A..Z), by 
  1025.     entering them with the Esc[ command, then using Esc] to save them.  They 
  1026.     can then be recalled and used with two keystrokes.  Example: typing Esc]3 
  1027.     will store the last Macro used as key 3, and it can be recalled and reused 
  1028.     at any future time simply by typing Esc3.  (40 more macros can also be 
  1029.     stored; see FUNCTION KEYS.)
  1030.          Ordinarily, macro keys operate just like the original Macro:  they 
  1031.     will ask for a "Repeat count" when executed.  In many cases, you will want 
  1032.     a key to execute only once when invoked; you can make a key "No-repeat" by 
  1033.     typing ^N before the keycode.  Example: Esc]^N3 stores a macro to key 3 as 
  1034.     a non-repeating sequence.  If you want the key to run in Quiet mode as 
  1035.     well (to increase speed and minimize display activity), you can instead 
  1036.     type ^Q: Esc]^Q3 stores a quiet, non-repeating sequence.
  1037.          Using a defined key brings its definition into the Macro buffer 
  1038.     (whence it can be stored again, if desired).  Trying to use an undefined 
  1039.     key results in an error.  You can delete a key definition by entering an 
  1040.     empty Macro string (Esc[, return) and storing it to the key.
  1041.          There is a total of 982 bytes available for all 36 keys, and a 128 
  1042.     byte limit for any one key.  (VDE's own input line will only accept 65 
  1043.     bytes, but VINSTALL can handle up to the full 128.)
  1044.          Besides simply storing any Macro, these Keys are useful for storing a 
  1045.     frequently repeated phrase; "Esc6" is much more convenient than "World Wide 
  1046.     Widgets Ltd. (N.A.)".  You might also define one as a common command like 
  1047.     ^PS, for underlining; or a set of margins, like ^OL5,CR,^OR60,CR.  A key 
  1048.     defined as ^QR,^N,Alt-D,^OF would place the current date at the top right 
  1049.     of a letter.
  1050.          Keys defined with Esc] are of course temporary.  [VINSTALL allows you 
  1051.     to install a permanent default set of Keys as well.]
  1052.  
  1053. MACRO PROGRAMMING (Esc-0..Z,!,=,~,(),+,-,&,;) -  VDE has several commands that 
  1054.     operate only in a Macro string, and give you conditional control over the 
  1055.     execution of a macro, allowing real programming.
  1056.          Esc0..Z, when in a Macro, function simply as "labels" 0..Z.  They 
  1057.     have no effect, but can be "jumped" to by other commands.
  1058.          Esc! followed by 0..Z is a simple "jump" instruction, causing macro 
  1059.     execution to resume with the command following the label Esc0..Z.  
  1060.     Example: Esc!2 jumps to label 2.  As two epecial cases, Esc![ jumps to 
  1061.     the beginning of the Macro, and Esc!] jumps to the end (aborts).
  1062.          Esc= and Esc~, followed by a character and then a label 0..Z (or 
  1063.     "[","]"), are conditional jumps: they jump to that label IF the character 
  1064.     at the cursor position does (or for "~", doesn't) match that specified. 
  1065.     Example: Esc~^M2 jumps to label 2 if the current character is NOT a CR.
  1066.          Esc= and Esc~, followed by a character and then ">" or "<", are 
  1067.     search loops.  They will continue to move the cursor right (or for "<", 
  1068.     left) as long as the character at the cursor does (or for "~", doesn't) 
  1069.     match, or until the beginning or end of the file.  Example: Esc=_> moves 
  1070.     right as long as the current character is a space.
  1071.          Several commands allow the use of a counter variable.  Esc() sets 
  1072.     the value: for example, Esc(0) initializes it to zero.  The Esc+ command 
  1073.     simply increments the value; Esc- decrements the value, then jumps if it 
  1074.     is zero to a specified label.  (In addition to a number, you may use "[" 
  1075.     or "]" for the start or end of the macro, or "@" to avoid jumping 
  1076.     entirely.)  Example: Esc-] decrements the counter, jumping to the end 
  1077.     (exiting) if it reaches zero.
  1078.          Esc&, followed by 0..Z, is used to "chain" to another macro key.  In 
  1079.     this way you can build up strings longer than the 65/128-byte limit on any 
  1080.     one key.  It does not "call" the key; there is no returning.  Example: 
  1081.     Esc&M chains to key M.
  1082.          Esc; (semicolon) gives a brief pause before execution continues, 
  1083.     presumably so the user can see what's happening on screen.
  1084.          Macro programs are stored just like any other macro string (usually 
  1085.     as No-repeat).  If you program in an endless loop, you will at some point 
  1086.     have to abort by pressing Esc.  Don't make macro programs Quiet until 
  1087.     you're sure they work.
  1088.          EXAMPLE 1: here is a good macro program (best stored as a Quiet key) 
  1089.     to move the cursor to the start of the current sentence:
  1090.               Esc~.1, ^S, Esc1, Esc~.<, Esc2, ^D, Esc=_2, Esc=^M2
  1091.     You could write this out in programmer's pseudo-code as:
  1092.               If not "." goto label1
  1093.               Move left                 ;move left if already on period
  1094.      label1:  While not "." move left   ;move left to previous period
  1095.      label2:  Move right                ;now move back right
  1096.               If " " goto label2        ;  as long as you see a space
  1097.               If "^M" goto label2       ;  or a Return
  1098.               (all done)
  1099.          EXAMPLE 2: a macro to move to the start of the current paragraph:
  1100.               ^QS, ^S,^S, Esc=_[, ^D,^D
  1101.          EXAMPLE 3: a macro to delete a word to the LEFT of the cursor:
  1102.               ^S,Esc~_2, Esc1, ^G,^S,Esc=_1, Esc2, ^G,^S,Esc~_2, ^D
  1103.          EXAMPLE 4: a macro to match parentheses.  Many programming languages 
  1104.     use nested sets of parentheses, for example "{}" in C.  This program, when 
  1105.     the cursor is placed on an open bracket, will move ahead to find the 
  1106.     closed bracket that matches it:
  1107.               Esc~{],Esc(0), Esc1,Esc~{2,Esc+,Esc!3
  1108.                              Esc2,Esc~}3,Esc-], Esc3,^D,Esc!1
  1109.          EXERCISE: suppose you have a file captured from an online session 
  1110.     with ProComm.  You corrected a lot of "misteaks" as you typed, using the 
  1111.     Backspace key -- and now that's all in the file:
  1112.                     I hardly ever make misteak^H^H^Hakes!
  1113.     Write a macro program to go through the file and neaten those all up, 
  1114.     deleting the erased characters along with the ^H's.
  1115.  
  1116.  
  1117.  
  1118. =========================  5. GENERAL INFORMATION  ===========================
  1119.  
  1120.  
  1121. DIRECTORIES -  It is important to recognize that if (via ^KN, ^KL, or the DOS 
  1122.     command line) you specify a directory as part of the current filename, 
  1123.     that directory acts as the default for all VDE file I/O commands, 
  1124.     extending or overriding the actual current DOS directory.  The directory 
  1125.     does not display in the header, but you can see it at the prompt for the 
  1126.     ^KF file directory command.  (If you are editing multiple files, each has 
  1127.     its own local directory.)
  1128.          If, for example, you enter VDE as follows:
  1129.                       C:\WORK>vde gort\myfil
  1130.     the file being edited is C:\WORK\GORT\MYFIL, and all VDE file operations 
  1131.     are going to assume the default directory C:\WORK\GORT.  So if you then 
  1132.     want to edit MYFIL2, in the same directory, just type ^KL,"MYFIL2"; DON'T 
  1133.     specify a directory again, unless you want a different one.
  1134.          None of this affects DOS in any way; if you use the Alt-R command, 
  1135.     the current DOS directory is still C:\WORK, or whatever you change it to 
  1136.     with CHDIR.
  1137.          If you try to load a file in an invalid directory, you will find that 
  1138.     you can edit the (empty!) file but will be unable to save it.  Use ^KN to 
  1139.     change to some valid directory and name.
  1140.  
  1141. DISK SPACE -  If you run out of disk space when writing a file, you can just 
  1142.     insert another disk.  (Always keep a blank FORMATTED disk around -- though 
  1143.     you can run FORMAT with Alt-R, if necessary.)  Alternatively, you can use 
  1144.     the ^KF and ^KE commands to purge unneeded files.  [If you have small 
  1145.     disks, you can also install VDE not to preserve BAK files.]
  1146.          Let VDE's filesize limits encourage you to break work up into files 
  1147.     of 64K or so; larger files make inefficient use of floppy disks, too.
  1148.  
  1149. ERROR MESSAGES -  Press Esc or Space to continue.  "Error" alone means the 
  1150.     command used just won't work in this situation.  (Example: a block command 
  1151.     was used with no block marked.)  More specific errors are:
  1152.       "Out of Memory" - the file, block, or key string won't fit in RAM.
  1153.         "Invalid Key" - an illegal command key sequence was pressed.
  1154.           "I/O Error" - file not found, disk full, invalid drive, etc.
  1155.     "Cannot Reformat" - word too long, or margins invalid.
  1156.           "Not Found" - the object of a search was not found.
  1157.        "Syntax Error" - a macro programming command was misused.
  1158.  
  1159.          NOTE: On DOS 2.x systems, an attempt to access an empty disk drive or 
  1160.     to print when the printer is not online can produce a critical error 
  1161.     message directly from DOS, something like:
  1162.                  "Device not ready; Ignore, Retry, or Abort?"
  1163.     If this should happen, correct the situation and press "R" for Retry.  
  1164.     Pressing "I" usually has no effect.  DO NOT PRESS "A", as this will exit 
  1165.     from VDE, losing any text in memory.
  1166.          If after recovering from such an error, the message is still on 
  1167.     screen, you can press ^OZ,Esc to redisplay your text.
  1168.  
  1169. FILE MODES -  VDE has four "file modes": "A"SCII document, "W"ordStar 
  1170.     document, WordStar "5" document, and "N"on-document.  The basic difference 
  1171.     is in the format of the disk files:
  1172.          In "W" mode, VDE reads and writes WordStar 3.3/4.0 compatible 
  1173.     document files.  NOTE: this compatibility is limited.  Any right justifi- 
  1174.     cation in a WordStar document will be LOST when the file is read into VDE.
  1175.          In "5" mode, VDE reads and writes WordStar 5.0 compatible document 
  1176.     files.  NOTE: this compatibility is very limited.  Features specific to 
  1177.     WordStar 5.0 (fonts, etc), as well as any right justification, will be 
  1178.     LOST when the file is read into VDE.
  1179.          In "A" or "N" mode, VDE reads and writes text as standard ASCII 
  1180.     characters, a universal format accepted by virtually all software.  These 
  1181.     two modes differ only in providing different sets of default options.  "A" 
  1182.     mode (like "W") is designed for word processing; "N" mode is for program- 
  1183.     ming and other special applications.
  1184.         DEFAULTS FOR:                 Margins     TABS    HARD CR DISP.
  1185.       documents ("A","W","5")         ACTIVE    variable      [on]
  1186.       "N"on-document                  DISABLED    hard        off
  1187.          The file mode option can be specified along with the filename at any 
  1188.     VDE file function prompt, allowing you to mix WordStar and ASCII disk 
  1189.     files as needed.  You can also change the current mode with the ^KN 
  1190.     command by entering a new mode (eg, "/W") with or without a filename. 
  1191.            NOTE: all WordStar/ASCII translation is in the disk I/O 
  1192.       routines.  Changing modes with ^KN has NO effect on text in 
  1193.       memory; it merely affects how it will be read or written to 
  1194.       disk.  Example: if you are in ASCII mode, and want to read in a 
  1195.       WordStar file, you must specify "/W" when you READ IN the file 
  1196.       (^KR).  Otherwise it will be read as an ASCII file with lots of 
  1197.       funny graphics in it.
  1198.          [The default mode (used when none is specified) is "A", but this can 
  1199.     be changed.  In addition, you can specify automatic filetype defaults to 
  1200.     declare exceptions (for example, all ".ASM" files as "N" mode).  See 
  1201.     VINSTALL.]
  1202.  
  1203.          NOTE ON FOREIGN ASCII FILES - If you edit an ASCII file created by 
  1204.     other software, you may find the format different from what VDE expects.
  1205.          1. HARD CRs.  The file may be properly formatted but full of hard 
  1206.     CRs, making it impossible to REformat.  There are two easy ways to solve 
  1207.     this problem: first, you can use ^QA to find "^M"s and selectively replace 
  1208.     them with " ^M".  Alternatively, the following Macro (best stored as a 
  1209.     Quiet macro Key) does a good job of "softening up" a paragraph:
  1210.                ^QS,^X,Esc=_],Esc=^M],^S,^V_^V,^D,Esc![
  1211.          2. NO CRs.  Some software stores every paragraph as one long line, 
  1212.     with CRs only at the end.  To read such files in VDE you may want to 
  1213.     reformat (^B) to your usual margins.  If you want to produce such a file 
  1214.     yourself, set the right margin (^OR) to "0" and reformat (^B) before 
  1215.     saving to disk.  (See MARGINS.)
  1216.  
  1217. MEMORY -  VDE edits each file in a 64k memory segment, unless resized (with 
  1218.     Alt-K).  (1k = 1024 bytes.)  If you check the usage of memory (^KI) you 
  1219.     will find that VDE compresses text: a file typically occupies 20-25% less 
  1220.     memory than its actual size.  Thus the maximum file size is roughly 80K.
  1221.          VDE runs well with anywhere from 256K to 640K RAM; the number and 
  1222.     size of files you can edit depends on the amount of memory you have.
  1223.          Running a DOS command requires enough free memory (beyond VDE's usage) 
  1224.     to load a copy of COMMAND.COM and any programs you intend to run under it.  
  1225.     You may not have enough memory to do this if (1) you are editing many 
  1226.     files with VDE, or (2) you have lots of memory-resident software.
  1227.  
  1228. PROMPTS -  First, VDE has several simple prompts requiring you to confirm an 
  1229.     action by typing "Y" or "N":
  1230.        "Abandon changes?" - warns the file you want to Quit has been changed.
  1231. "Unchanged! save anyway?" - reminds the file you want saved isn't changed.
  1232.        "Delete original?" - do you want to delete block copied from 2nd file.
  1233.                    "Chg?" - do you want to change this instance of a string?
  1234.                   "Join?" - do you want to join this hyphenated word?
  1235.     Then, there are a few special purpose prompts:
  1236.          "Repeat count:" - enter (optional "^Q" and) repeat count for Macro.
  1237.            "Key number:" - enter (optional "^N/Q" and) key number for Key.
  1238.                    "Rdy" - press any key to print next page (Esc quits).
  1239.     Finally, there are a variety of prompts for either numeric or string 
  1240.     input, like "Column:" or "Find string:".  You are expected to type in a 
  1241.     string (up to 65 characters).  The following control keys operate:
  1242.          Correct mistake:     BS (^H)
  1243.          Erase entire entry:  ^X
  1244.          Finish entry:        CR (^M) or LF (^J)
  1245.          Abort operation:     ^U
  1246.     Note that to get any of these codes into the string itself, you must 
  1247.     precede it with ^P (this includes ^P).
  1248.          Examples: to find a line beginning with a "*" (find "^M,*") type
  1249.                      ^QF,^P-CR,*,CR.
  1250.  
  1251. WORDSTAR COMPATIBILITY -  Depending on your needs, you can use VDE as either 
  1252.     an accessory to WordStar, or a substitute for it.  (For example, I 
  1253.     generally do all my writing in VDE, using its speed and extra features, 
  1254.     but often want to take advantage of WordStar's more sophisticated printing 
  1255.     abilities -- dot commands, etc -- to print out the result.)
  1256.          In most respects VDE operates much like WordStar; one big difference 
  1257.     is the absence of a "No-File" menu.  You are always in edit mode; use ^KL 
  1258.     to select a new file, or Alt-R to run DOS commands COPY, REN, etc.
  1259.          VDE lacks some WordStar commands, and has some of its own.  (These 
  1260.     may overlap: for example, VDE macros can do anything that WordStar's ^QQ 
  1261.     can, and more.)  Aside from these, there are the following differences in 
  1262.     common commands:
  1263.  
  1264.         COMMON USE      WORDSTAR 4   VDE 1.3           VDE NOTES
  1265.     Hide block            ^KH          ^KU      Actually unmarks block.
  1266.     Erase disk file       ^KJ          ^KE
  1267.     Set Place Mark       ^K0..9        ^PZ      Not individually numbered.
  1268.     Go to Place Mark     ^Q0..9        ^QZ      Cyclic.
  1269.     Time, Date stamp     Esc!,@      Alt-T,D
  1270.  
  1271.       COMMON COMMAND     WORDSTAR 4 USE               VDE USE
  1272.           ^^ (^6)       Soften hard CR        Transpose upper/lowercase
  1273.            ^KN          Column block mode     Rename current work
  1274.            ^OB          Display soft spaces   Display hard CRs
  1275.            ^OF          Ruler from text       Flush right
  1276.            ^OP          Preview mode          Set page length
  1277.  
  1278.     Note also that VDE does not recognize WordStar "dot commands" in text, 
  1279.     though in "W" or "5" mode it will avoid printing them.  You can get a page 
  1280.     break (WordStar .PA) in VDE with the ^PL command.
  1281.  
  1282.  
  1283. ===========================  6. TIPS ON USING VDE  ===========================
  1284.  
  1285.  
  1286. EDITING SAME FILE TWICE.  In your use of Alt-L, try to avoid editing two files 
  1287.     with the same name at the same time.  VDE will let you do this, but it can 
  1288.     be visually confusing, and upon saving, one might overwrite the other.
  1289.          If for any reason you want to edit two copies of the same file (for 
  1290.     example, to use Alt-M to see what changes you have made since your last 
  1291.     save), use the ^KN command promptly to rename the second copy (to "COPY", 
  1292.     perhaps, or "FILE.BAK") before proceeding.
  1293.  
  1294. FORMAT CONVERSION.  Since VDE can read files in several formats (ASCII, 
  1295.     WordStar 3/4, WordStar 5), you can easily use it to convert files from one 
  1296.     of these formats to another.  Simply load the file with the appropriate 
  1297.     mode, use ^KN to specify a new name and a different mode, and save.
  1298.  
  1299. PROGRAMMING.  VDE (in "N"ondocument mode) makes a fine programmer's editor.  
  1300.     The auto-indent (^OA) function is convenient for many structured 
  1301.     programming languages including C and Pascal.
  1302.          A growing number of languages today include their own "integrated" 
  1303.     editor, that guides you straight to errors detected during compilation.  
  1304.     You can use VDE in a very similar manner, if you have a compiler or 
  1305.     assembler that generates typical error messages (such as "Line 1091: Type 
  1306.     of operands must match").  After saving your source file to disk, just use 
  1307.     the Alt-R command to run the compiler, with the MSDOS ">" option to 
  1308.     redirect output to a disk file; for example,
  1309.                      C:\WORK>compile prog.c >listing
  1310.     Then use Alt-L to load the error reports in LISTING.  You can go back and 
  1311.     forth between LISTING and PROG.C (windowing both if desired), using the 
  1312.     ^QI command to move to each line where an error was detected.
  1313.  
  1314. TRANSPOSING TEXT.  Often you may need to switch the order of letters, words, 
  1315.     or lines erroneously typed.  The "undelete" feature can be exploited to 
  1316.     move text, rather like a quick-and-dirty block move.  For example, if the 
  1317.     cursor is at the start of a word, the sequence of commands ^T^F^U (which 
  1318.     of course can be assigned to a macro key) will swap that word with the one 
  1319.     following it.  Similarly ^G^D^U will swap a pair of letters, and ^Y^X^U 
  1320.     will swap two lines.
  1321.  
  1322.  
  1323.  
  1324. ===============================  7. HISTORY  =================================
  1325.  
  1326.  
  1327.        1984-1987:  Development of CP/M VDE through version 2.62.
  1328. VDE 1.0  (12/87):  First MSDOS release.  IBM PC compatible version only.
  1329.     1.01 (12/87):  Faster; several bug fixes; minor changes to VINSTALL.
  1330.     1.1  (01/88):  Generic MSDOS ANSI.SYS support; EGA 43-line support;
  1331.                   Dual-file editing; DOS Shell; Time/date stamps.
  1332.     1.2  (03/88):  Window, copy, match between files; Run a command; Split 
  1333.                   large file; ^KD,^OQ,^QT,^QI; Graphics; [F]unction keys;
  1334.                   backward find; word count; new print options.
  1335.     1.21 (05/88):  Auto indent; tab set enhancements; ^PL starts new page.
  1336.     1.22 (08/88):  Append to existing file; Print to file; Printer top, left 
  1337.                   margin; Alt-O,I,A; enhanced speed & appearance; VGA support.
  1338.     1.3  (01/89):  Edit up to 6 files; dual printer drivers; improved replace, 
  1339.                   undelete; WordStar 5 file mode; many small improvements.
  1340.     1.31 (03/89):  Auto numbering; block zoom; macro keys A-Z; Alt-U; ^OD.
  1341.  
  1342.      See the accompanying file VDExxx.UPD for a more detailed account of 
  1343. changes in the most recent release.
  1344.  
  1345. ==============================================================================
  1346.